Appendix A 



// File: gbLogicAPI.h 

#ifndef _GBLOGICAPI_H 
#define _GBLOGICAPI_H 

/* 

* Data types 
*/ 



// return status for all GB watermarking logic calls 
typedef enum { 

GB_nil, 

GB_ok, 

GB_deny, 

GB_prepare^ 

GB^reauth, 
} GB action t; 



// unexpected error condition 

// success condition 

// incoming segment to be dropped 

// cliient monitor is to perform synch 

// serv. mon. to request client resynch 



// 16-bit watermark data type 
typedef struct { char bytes [ 2]; } 



GB watermark t; 



// 256-bit shared secret state agreement data type 
typedef struct { char bytes [ 32]; } GB_agreement_t ; 

// opaque context for watermarking logic module 
typedef struct GB_context_s GB_context_t ; 



* Housekeeping 
*/ 

// constructor 

GB_context_t * gblnitialize ( ); 
// destructor 

void gbFinalize( GB_context_t * ctx) ; 

* Client calls 



// return values: GB_nil, GB_ok 
GB_action_t 

gbPrepareWMark ( GB_context_t * ctx, 

GB_agreement_t * data, 
ipaddr_t src, 
ipaddr_t dst) ; 
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// return values: GB__nil, GB_ok, GB_prepare 
GB_action__t 

gbWMarkOutgoing ( GB_context_t * ctx, 

GB_watermark_t * mark, 
ipaddr__t src, 
ipaddr_t dst) ; 

/* 

* Server calls 
*/ 

// return values: GB_nil, GB_ok, GB_deny 

GB_action_t 

gbSynchronizeWMark ( GB_context__t * ctx, 

GB_agreement_t const * data, 
ipaddr_t src, 
ipaddr_t dst); 

// return values: GB_nil, GB_ok, GB_deny, GB_reauth 

GB_action_t 

gbWMarklncoming ( GB_context_t * ctx, 

GB_watermark_t const * mark, 

ipaddr_t src, 

ipaddr_t dst, 

void const * segment_hdr) ; 



#endif /* _GBLOGICAPI_H */ 
// End of file 



24 



